Installing iTools 6.0 on MacOS X

iTools 6.0
6 April 2001

Installation Dependencies
You must NOT be "root" Administrator  to install iTools. You should install this package as any user in the "admin" group.

iTools is a family of networking applications and requires a properly setup configuration. For iTools to operate properly,  the MacOS X system must be configured with a hostname, IP address,  domainname, and an IP address for a Domain Name Server . The current implementation
of Mac OS X does not supply a way to set the hostname of the machine in the preferences panel, so upon installing the iTools package, and
application will run which will let you specify these values. These vales will then be properly set in the system.

Use Mac OS X's "Preferences/Network"  to set a domainname and IP addresses. If necessary, consult with your network administrator and the MacOS X documentation for more information.

Backup Existing Apache Configuration File
If you have made changes to /etc/httpd/httpd.conf, save a copy of this file.

Installation
Install the iTools package using the Mac OS X package installer. The installer creates the following files and directories. Subdirectories are not shown here but can be found in the package installer's log files. 

	/Library/WebServer/tenon
	/Applications/iTools.app/
	/usr/local/squid -> /Library/WebServer/tenon/squid

The installation may take up to 20 mins including the "Optimizing System" stage.  After installation, iTools will be configured and running.

iTools Daemons
iTools was updated to contain new DNS (BIND 8.3) and FTPD (wu-ftpd-1.3.6) implementations to close a number of security holes that exist in the versions distributed from Apple.  BIND 4.9.2 had a number of problems with the ability of outsiders to modify zone information without proper authority.  FTPD was updated to support virtual FTP hosts and improved file access controls.  

After iTools is installed, the DNS and FTPD daemons are made active on your system.  If you do not need these daemons running, you should turn them off as they waste system overhead.  The paragraphs below show how each daemon can be shut off if it is not needed.

DNS Daemon. Unless iTools finds evidence that the Domain Name Server (DNS) application - named - is running or installed, iTools will save any existing DNS configuration files in /Library/WebServer/tenon/Backups/MACOSX-named.tgz.  After preserving any existing named information and binary applications, the iTools installer updates the named software with BIND 8.3, creates named configuration information in a new /etc/named directory and installs a named start file in the /etc/startup directory.  The /etc/hostconfig file is then modified to set DNSSERVER=-YES- so that named will be started automatically during system restart.  If you do not plan to use the local machine as a DNS server, you should modify the DNSSERVER entry in the  /etc/hostconfig file as DNSSERVER=-NO- and restart the system.  This will save system overhead.

FTP Daemon.  The FTP daemon is preserved and controlled in the same way the Sendmail Daemon is controlled.  Any existing files are stored in /Library/WebSServer/tenon/backups/MACOSX-ftpd.tgz.  Then the iTools installer updates the ftp daemon software and startup information.  The FTP daemon startup can be controlled by the Mac OS X "Preferences->Network" application or Mac OS X Server's  "APPLE->Computer Settings->Network" control panel and selection of the "Servers" tab item.  The FTP Server may be selected as ON or OFF to cause the daemon to run or not at system restart.

We urge you strongly to turn these daemons off if they will not be used by your system.  It saves processor and memory overhead as well as reduces the risk that any external forces can attack your system.

Interesting URLs
Use a browser to connect to the local system.  The default URL "http://<hostname>.<domainname>"  should give you the content previously available from the Apple supplied web server.  Here are a few more interesting URLs.

http://<hostname>.<domainname>/itools_admin	You should get the iTools administration page.  With this page you can create new virtual hosts.  Create SSL support.  Add users and groups.  Look at status and operations logs for the web server and much more.
The initial username is 'admin' and the initial password is 'admin'.  You are strongly advised to change these defaults.  See Setting Admin Password below.

Launching iTools
iTools includes a Mac OS X application designed to modify local administration username and password information, change Tenon software licensing, start and stop the web server and adminstration server and flush cache.  Each of these entries is available from the Admin menu item.  As one of the first system operations, you should change the default administration user name (default: admin) and password (default: admin) .  See Setting the Admin Password below.

To start the iTools Mac OS X manager application, use the Workspace Manager to launch the iTools Front End application "/Applications/iTools.app". This application automatically launches the iTools servers (daemons) if they are not already running. This application can be quit at any time. The iTools servers are not automatically stopped when the Front End application is quit. The iTools Front End application can be restarted at any time. The iTools servers are not restarted if they are already running when the Front End application is launched. You do not need to be the "root" user to launch iTools.

Setting the Admin Password
Pull down the "Admin" menu and select the "Set Admin Password" item. Enter a username and password for the iTools Administration Server. This username and password is used only by iTools. It need not exist in the system password database nor does iTools enter it into the system password database. If you enter a username other then admin, the default admin user will be deleted.

Add-on Packages to Enhance iTools
Several pre-built, pre-configured software packages are available for iTools to add functionality to the iTools Web Server.
These include WebCatalog, a powerful eCommerce storefront; WebMail, a web-based email client/server; HtDig, a popular
and full-featured search engine; and WebEvent, a calandar and appointment scheduler.